home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 3 / Info_Mac_1994-01.iso / Development / Source / MSG Graphic Effects 1.0 Source / Usage.note < prev   
Encoding:
Text File  |  1993-08-23  |  1.3 KB  |  27 lines  |  [TEXT/KAHL]
  1. /*
  2.  
  3. How to use these graphics effects:
  4.  
  5. - Each effect is passed a GrafPtr, which is an off-screen bitmap that has the
  6.   picture you want to eventually get on the on-screen window.  You must create
  7.   this GrafPtr yourself and draw the picture on it, then call the graphic
  8.   effect routine.
  9. - The on-screen destination window is named gMainWindow (as defined in
  10.   "msg misc.h", although you could change this to a #-define if you have
  11.   another name for your on-screen window).  gMainWindow's dimensions are
  12.   given as MAIN_WINDOW_HEIGHT and MAIN_WINDOW_WIDTH, which are #-defined in
  13.   "msg misc.h".  
  14. - Some graphics effects need to allocate memory (e.g. dissolve).  If there is
  15.   no memory available, the procedure will call ErrorString(Str255, Str255),
  16.   which puts up an alert and exits the program.  (This procedure is not
  17.   included.  Ideally, you should check for memory _before_ you call routines
  18.   that allocate memory, so you won't need this anyway.)
  19. - To ensure that graphics effects run at the same speed on all machines,
  20.   "msg timing" contains procedures to do time corrections based on the tick
  21.   count, which is a standard speed on all machines.  Each graphics effect
  22.   calls StartTiming() in the beginning of its inner loop, and calls
  23.   TimeCorrection(CorrectTime) at the end of the inner loop.  CorrectTime is
  24.   #-defined for each graphic effect.
  25.  
  26. */
  27.